updateAppointment
updateAppointment
Path Parameters
appointment_uuid string required
appointment_uuid
Header Parameters
authorization string required
authorization
application/json
Request Body required
request
appointmentKey string
appointmentMetaData object
assignedUser object
customerVehicleUuid string
dealerDepartmentUuidList string[]
destinationAddress string
destinationLatitude double
destinationLongitude double
emailPreference boolean
internalNotes string
lastMileage string
notifyCustomer boolean
orderNumber string
orderUuid string
platform string
Possible values: [DEALER_APP
, WEB
, MOBILE_APP
, DMS
, TRANSPORTATION_EVENTS_CONSUMER
]
preferredDate string
publicNotes string
quickOpList object[]
requesterUserUuid string
serviceAdvisor object
serviceEndTime string
serviceStartTime string
sprinterVehicleUuid string
status string
Possible values: [PENDING_APPROVAL
, SCHEDULED
, TRIP_IN_PROGRESS
, TECHNICIAN_ARRIVED
, SERVICE_IN_PROGRESS
, SERVICE_COMPLETED
, CANCELLED
, COMPLETED
, DECLINED
]
textPreference boolean
updatedByUser object
Responses
- 200
- 204
- 401
- 403
OK
application/json
Schema
Example (from schema)
Schema
appointmentUUID string
error object
statusCode int32
warnings object[]
{
"appointmentUUID": "string",
"error": {
"code": "string",
"description": "string",
"metadata": {}
},
"statusCode": 0,
"warnings": [
{
"code": "string",
"description": "string"
}
]
}
No Content
Unauthorized
Forbidden
PATCH /appointment/:appointment_uuid
Request
Request
curl / cURL
curl -L -X PATCH '//api.mykaarma.com/mobile-service/appointment/:appointment_uuid' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"appointmentKey": "string",
"appointmentMetaData": {
"dmsMetaData": {
"dealerAssociateId": "string",
"description": "string",
"title": "SUCCESS",
"type": "PUSH",
"vehicleUuid": "string"
}
},
"assignedUser": {
"departmentUuid": "string",
"isMobileServiceTechnician": true,
"isValid": true,
"userUuid": "string"
},
"customerVehicleUuid": "string",
"dealerDepartmentUuidList": [
"string"
],
"destinationAddress": "string",
"destinationLatitude": 0,
"destinationLongitude": 0,
"emailPreference": true,
"internalNotes": "string",
"lastMileage": "string",
"notifyCustomer": true,
"orderNumber": "string",
"orderUuid": "string",
"platform": "DEALER_APP",
"preferredDate": "string",
"publicNotes": "string",
"quickOpList": [
{
"description": "string",
"laborOpCode": "string",
"opCodeDuration": "string",
"opCodeName": "string",
"quickOpLiteUUID": "string",
"totalPrice": "string"
}
],
"requesterUserUuid": "string",
"serviceAdvisor": {
"departmentUuid": "string",
"isMobileServiceTechnician": true,
"isValid": true,
"userUuid": "string"
},
"serviceEndTime": "string",
"serviceStartTime": "string",
"sprinterVehicleUuid": "string",
"status": "PENDING_APPROVAL",
"textPreference": true,
"updatedByUser": {
"departmentUuid": "string",
"isMobileServiceTechnician": true,
"isValid": true,
"userUuid": "string"
}
}'
python / requests
curl -L -X PATCH '//api.mykaarma.com/mobile-service/appointment/:appointment_uuid' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"appointmentKey": "string",
"appointmentMetaData": {
"dmsMetaData": {
"dealerAssociateId": "string",
"description": "string",
"title": "SUCCESS",
"type": "PUSH",
"vehicleUuid": "string"
}
},
"assignedUser": {
"departmentUuid": "string",
"isMobileServiceTechnician": true,
"isValid": true,
"userUuid": "string"
},
"customerVehicleUuid": "string",
"dealerDepartmentUuidList": [
"string"
],
"destinationAddress": "string",
"destinationLatitude": 0,
"destinationLongitude": 0,
"emailPreference": true,
"internalNotes": "string",
"lastMileage": "string",
"notifyCustomer": true,
"orderNumber": "string",
"orderUuid": "string",
"platform": "DEALER_APP",
"preferredDate": "string",
"publicNotes": "string",
"quickOpList": [
{
"description": "string",
"laborOpCode": "string",
"opCodeDuration": "string",
"opCodeName": "string",
"quickOpLiteUUID": "string",
"totalPrice": "string"
}
],
"requesterUserUuid": "string",
"serviceAdvisor": {
"departmentUuid": "string",
"isMobileServiceTechnician": true,
"isValid": true,
"userUuid": "string"
},
"serviceEndTime": "string",
"serviceStartTime": "string",
"sprinterVehicleUuid": "string",
"status": "PENDING_APPROVAL",
"textPreference": true,
"updatedByUser": {
"departmentUuid": "string",
"isMobileServiceTechnician": true,
"isValid": true,
"userUuid": "string"
}
}'
go / native
curl -L -X PATCH '//api.mykaarma.com/mobile-service/appointment/:appointment_uuid' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"appointmentKey": "string",
"appointmentMetaData": {
"dmsMetaData": {
"dealerAssociateId": "string",
"description": "string",
"title": "SUCCESS",
"type": "PUSH",
"vehicleUuid": "string"
}
},
"assignedUser": {
"departmentUuid": "string",
"isMobileServiceTechnician": true,
"isValid": true,
"userUuid": "string"
},
"customerVehicleUuid": "string",
"dealerDepartmentUuidList": [
"string"
],
"destinationAddress": "string",
"destinationLatitude": 0,
"destinationLongitude": 0,
"emailPreference": true,
"internalNotes": "string",
"lastMileage": "string",
"notifyCustomer": true,
"orderNumber": "string",
"orderUuid": "string",
"platform": "DEALER_APP",
"preferredDate": "string",
"publicNotes": "string",
"quickOpList": [
{
"description": "string",
"laborOpCode": "string",
"opCodeDuration": "string",
"opCodeName": "string",
"quickOpLiteUUID": "string",
"totalPrice": "string"
}
],
"requesterUserUuid": "string",
"serviceAdvisor": {
"departmentUuid": "string",
"isMobileServiceTechnician": true,
"isValid": true,
"userUuid": "string"
},
"serviceEndTime": "string",
"serviceStartTime": "string",
"sprinterVehicleUuid": "string",
"status": "PENDING_APPROVAL",
"textPreference": true,
"updatedByUser": {
"departmentUuid": "string",
"isMobileServiceTechnician": true,
"isValid": true,
"userUuid": "string"
}
}'
nodejs / axios
curl -L -X PATCH '//api.mykaarma.com/mobile-service/appointment/:appointment_uuid' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"appointmentKey": "string",
"appointmentMetaData": {
"dmsMetaData": {
"dealerAssociateId": "string",
"description": "string",
"title": "SUCCESS",
"type": "PUSH",
"vehicleUuid": "string"
}
},
"assignedUser": {
"departmentUuid": "string",
"isMobileServiceTechnician": true,
"isValid": true,
"userUuid": "string"
},
"customerVehicleUuid": "string",
"dealerDepartmentUuidList": [
"string"
],
"destinationAddress": "string",
"destinationLatitude": 0,
"destinationLongitude": 0,
"emailPreference": true,
"internalNotes": "string",
"lastMileage": "string",
"notifyCustomer": true,
"orderNumber": "string",
"orderUuid": "string",
"platform": "DEALER_APP",
"preferredDate": "string",
"publicNotes": "string",
"quickOpList": [
{
"description": "string",
"laborOpCode": "string",
"opCodeDuration": "string",
"opCodeName": "string",
"quickOpLiteUUID": "string",
"totalPrice": "string"
}
],
"requesterUserUuid": "string",
"serviceAdvisor": {
"departmentUuid": "string",
"isMobileServiceTechnician": true,
"isValid": true,
"userUuid": "string"
},
"serviceEndTime": "string",
"serviceStartTime": "string",
"sprinterVehicleUuid": "string",
"status": "PENDING_APPROVAL",
"textPreference": true,
"updatedByUser": {
"departmentUuid": "string",
"isMobileServiceTechnician": true,
"isValid": true,
"userUuid": "string"
}
}'
ruby / Net::HTTP
curl -L -X PATCH '//api.mykaarma.com/mobile-service/appointment/:appointment_uuid' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"appointmentKey": "string",
"appointmentMetaData": {
"dmsMetaData": {
"dealerAssociateId": "string",
"description": "string",
"title": "SUCCESS",
"type": "PUSH",
"vehicleUuid": "string"
}
},
"assignedUser": {
"departmentUuid": "string",
"isMobileServiceTechnician": true,
"isValid": true,
"userUuid": "string"
},
"customerVehicleUuid": "string",
"dealerDepartmentUuidList": [
"string"
],
"destinationAddress": "string",
"destinationLatitude": 0,
"destinationLongitude": 0,
"emailPreference": true,
"internalNotes": "string",
"lastMileage": "string",
"notifyCustomer": true,
"orderNumber": "string",
"orderUuid": "string",
"platform": "DEALER_APP",
"preferredDate": "string",
"publicNotes": "string",
"quickOpList": [
{
"description": "string",
"laborOpCode": "string",
"opCodeDuration": "string",
"opCodeName": "string",
"quickOpLiteUUID": "string",
"totalPrice": "string"
}
],
"requesterUserUuid": "string",
"serviceAdvisor": {
"departmentUuid": "string",
"isMobileServiceTechnician": true,
"isValid": true,
"userUuid": "string"
},
"serviceEndTime": "string",
"serviceStartTime": "string",
"sprinterVehicleUuid": "string",
"status": "PENDING_APPROVAL",
"textPreference": true,
"updatedByUser": {
"departmentUuid": "string",
"isMobileServiceTechnician": true,
"isValid": true,
"userUuid": "string"
}
}'
csharp / RestSharp
curl -L -X PATCH '//api.mykaarma.com/mobile-service/appointment/:appointment_uuid' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"appointmentKey": "string",
"appointmentMetaData": {
"dmsMetaData": {
"dealerAssociateId": "string",
"description": "string",
"title": "SUCCESS",
"type": "PUSH",
"vehicleUuid": "string"
}
},
"assignedUser": {
"departmentUuid": "string",
"isMobileServiceTechnician": true,
"isValid": true,
"userUuid": "string"
},
"customerVehicleUuid": "string",
"dealerDepartmentUuidList": [
"string"
],
"destinationAddress": "string",
"destinationLatitude": 0,
"destinationLongitude": 0,
"emailPreference": true,
"internalNotes": "string",
"lastMileage": "string",
"notifyCustomer": true,
"orderNumber": "string",
"orderUuid": "string",
"platform": "DEALER_APP",
"preferredDate": "string",
"publicNotes": "string",
"quickOpList": [
{
"description": "string",
"laborOpCode": "string",
"opCodeDuration": "string",
"opCodeName": "string",
"quickOpLiteUUID": "string",
"totalPrice": "string"
}
],
"requesterUserUuid": "string",
"serviceAdvisor": {
"departmentUuid": "string",
"isMobileServiceTechnician": true,
"isValid": true,
"userUuid": "string"
},
"serviceEndTime": "string",
"serviceStartTime": "string",
"sprinterVehicleUuid": "string",
"status": "PENDING_APPROVAL",
"textPreference": true,
"updatedByUser": {
"departmentUuid": "string",
"isMobileServiceTechnician": true,
"isValid": true,
"userUuid": "string"
}
}'
php / cURL
curl -L -X PATCH '//api.mykaarma.com/mobile-service/appointment/:appointment_uuid' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"appointmentKey": "string",
"appointmentMetaData": {
"dmsMetaData": {
"dealerAssociateId": "string",
"description": "string",
"title": "SUCCESS",
"type": "PUSH",
"vehicleUuid": "string"
}
},
"assignedUser": {
"departmentUuid": "string",
"isMobileServiceTechnician": true,
"isValid": true,
"userUuid": "string"
},
"customerVehicleUuid": "string",
"dealerDepartmentUuidList": [
"string"
],
"destinationAddress": "string",
"destinationLatitude": 0,
"destinationLongitude": 0,
"emailPreference": true,
"internalNotes": "string",
"lastMileage": "string",
"notifyCustomer": true,
"orderNumber": "string",
"orderUuid": "string",
"platform": "DEALER_APP",
"preferredDate": "string",
"publicNotes": "string",
"quickOpList": [
{
"description": "string",
"laborOpCode": "string",
"opCodeDuration": "string",
"opCodeName": "string",
"quickOpLiteUUID": "string",
"totalPrice": "string"
}
],
"requesterUserUuid": "string",
"serviceAdvisor": {
"departmentUuid": "string",
"isMobileServiceTechnician": true,
"isValid": true,
"userUuid": "string"
},
"serviceEndTime": "string",
"serviceStartTime": "string",
"sprinterVehicleUuid": "string",
"status": "PENDING_APPROVAL",
"textPreference": true,
"updatedByUser": {
"departmentUuid": "string",
"isMobileServiceTechnician": true,
"isValid": true,
"userUuid": "string"
}
}'
java / OkHttp
curl -L -X PATCH '//api.mykaarma.com/mobile-service/appointment/:appointment_uuid' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"appointmentKey": "string",
"appointmentMetaData": {
"dmsMetaData": {
"dealerAssociateId": "string",
"description": "string",
"title": "SUCCESS",
"type": "PUSH",
"vehicleUuid": "string"
}
},
"assignedUser": {
"departmentUuid": "string",
"isMobileServiceTechnician": true,
"isValid": true,
"userUuid": "string"
},
"customerVehicleUuid": "string",
"dealerDepartmentUuidList": [
"string"
],
"destinationAddress": "string",
"destinationLatitude": 0,
"destinationLongitude": 0,
"emailPreference": true,
"internalNotes": "string",
"lastMileage": "string",
"notifyCustomer": true,
"orderNumber": "string",
"orderUuid": "string",
"platform": "DEALER_APP",
"preferredDate": "string",
"publicNotes": "string",
"quickOpList": [
{
"description": "string",
"laborOpCode": "string",
"opCodeDuration": "string",
"opCodeName": "string",
"quickOpLiteUUID": "string",
"totalPrice": "string"
}
],
"requesterUserUuid": "string",
"serviceAdvisor": {
"departmentUuid": "string",
"isMobileServiceTechnician": true,
"isValid": true,
"userUuid": "string"
},
"serviceEndTime": "string",
"serviceStartTime": "string",
"sprinterVehicleUuid": "string",
"status": "PENDING_APPROVAL",
"textPreference": true,
"updatedByUser": {
"departmentUuid": "string",
"isMobileServiceTechnician": true,
"isValid": true,
"userUuid": "string"
}
}'
powershell / RestMethod
curl -L -X PATCH '//api.mykaarma.com/mobile-service/appointment/:appointment_uuid' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"appointmentKey": "string",
"appointmentMetaData": {
"dmsMetaData": {
"dealerAssociateId": "string",
"description": "string",
"title": "SUCCESS",
"type": "PUSH",
"vehicleUuid": "string"
}
},
"assignedUser": {
"departmentUuid": "string",
"isMobileServiceTechnician": true,
"isValid": true,
"userUuid": "string"
},
"customerVehicleUuid": "string",
"dealerDepartmentUuidList": [
"string"
],
"destinationAddress": "string",
"destinationLatitude": 0,
"destinationLongitude": 0,
"emailPreference": true,
"internalNotes": "string",
"lastMileage": "string",
"notifyCustomer": true,
"orderNumber": "string",
"orderUuid": "string",
"platform": "DEALER_APP",
"preferredDate": "string",
"publicNotes": "string",
"quickOpList": [
{
"description": "string",
"laborOpCode": "string",
"opCodeDuration": "string",
"opCodeName": "string",
"quickOpLiteUUID": "string",
"totalPrice": "string"
}
],
"requesterUserUuid": "string",
"serviceAdvisor": {
"departmentUuid": "string",
"isMobileServiceTechnician": true,
"isValid": true,
"userUuid": "string"
},
"serviceEndTime": "string",
"serviceStartTime": "string",
"sprinterVehicleUuid": "string",
"status": "PENDING_APPROVAL",
"textPreference": true,
"updatedByUser": {
"departmentUuid": "string",
"isMobileServiceTechnician": true,
"isValid": true,
"userUuid": "string"
}
}'